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INFER  SYSTEM  SPECIFICATION 


1.0  INTRODUCTION 


1:1  Purpose  of  the  System  Specification 

The  INFER  System  Specification  is  a  technical  document 
written  for  software  development  personnel.  Together  with 
the  INFER  Functional  Description,  the  System  Specification 
guides  the  software  development  effort  by  identifying  the 
functional  requirements  and  by  providing  structured  logic 
diagrams  that  depict  the  flow,  control,  and  processing  of 
information  within  the  system. 

The  System  Specification  is  generic  documentation 
intended  to  guide  and  facilitate  the  preparation  of  the 
language- specific  and  computer  hardware-specific  program 
documentation  and  coding  that  are  necessary  to  implement  and 
operate  INFER  at  an  installation. 

_ _ _ 

1.2  References 

1.2.1  IBM,  HIPO — A  Design  Aid  and  Documentation  Tech¬ 
nique.  Technical  Publication  GC20-1851-0. 

White  Plains,  New  York:  IBM,  October  1974. 

1.2.2  Amey,  Dorothy  M. t  Feuerwerger,  Phillip  H. ; 

Gulick,  Roy  M.  Documentation  of  Decision-Aiding 
Software:  INFER  Functional  Description.  McLean , 
Virginia:  Decisions  and  Designs,  Inc.,  June 
1979. 

1.2.3  Amey,  Dorothy  M. ?  Feuerwerger,  Phillip  H. ; 

Gulick,  Roy  M.  Documentation  of  Decision-Aiding 
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Software:  INFER  Users  Manual.  McLean ,  Virginia : 
Decisions  and  Designs,  Inc.,  June  1979. 


1.3  Terms 


1.3.1  INFER  -  The  name  of  the  system,  INFER,  is  an 
abbreviation  for  inference,  reflecting  the  logical  process 
supported  by  the  software. 

1.3.2  HIPO  -  The  specification  uses  the  standard  Hier¬ 
archy  plus  Input-Process-Output  (HIPO)  diagramming  technique 
to  depict  the  structural  design  and  logical  flow  of  the 
system.  A  legend  explaining  the  HIPO  diagramming  symbols  is 
included.  Reference  1.2.1  provides  a  complete  description 
of  the  HIPO  documentation  technique. 


2.0  DESIGN  DETAILS 


2.1  Background 

Systems  development  personnel  should  refer  to  the  INFER 
Functional  Description,  reference  1.2.2,  in  conjunction  with 
the  documentation  contained  in  this  specification.  The 
Functional  Description  details  the  inference  models  imple- 
men ted  by  INFER  and  discusses  the  specific  functions  that 
the  software  must  perform.  In  addition,  systems  development 
personnel  may  wish  to  refer  to  the  INFER  User*s  Manual, 
Reference  1.2.3. 

2. 2  General  Operating  Procedures 

INFER  is  a  menu-driven  system.  That  is,  the  system  is 
designed  to  interact  with  the  user  by  presenting  a  sequen¬ 
tial  hierarchy  of  menus  and  asking  the  user  to  respond  by 
selecting  one  option  from  the  current  menu.  If  the  user 
does  not  select  one  of  the  menu  options,  the  system  displays 
the  previous  menu.  In  this  manner,  the  user  moves  up  and 
down  the  hierarchy,  as  desired.  Whenever  data  entry  is 
required  as  a  result  of  option  selection,  the  system  spe¬ 
cifically  requests  the  data  and  specifies  the  format. 

The  system  is  also  designed  to  be  generally  forgiving 
of  procedural  errors  by  the  user. 

2. 3  System  Logical  Flow 

INFER  is  a  hierarchically  structured,  modular  software 
system.  The  system  structure  and  logical  flow  lends  itself 
to  presentation  in  the  form  of  HIPO  diagrams,  which  are 
contained  in  this  document. 


The  main  purpose  of  the  HIPO  diagrams  is  to  provide,  in 
a  pictorial  manner,  the  complete  set  of  modular  elements 
necessary  to  the  operation  of  INFER  including  all  input, 
output,  and  internal  functional  processing.  This  is  done  by 
displaying  input  items  to  the  process  step  which  uses  them, 
defining  the  process,  and  showing  the  resulting  output  of 
the  process  step. 

The  HIPO  documentation  diagrams  are  designed  and  drawn 
in  a  hierarchical  fashion  from  the  main  calling  routines  to 
the  detail-level  operation/calculation  routines.  Extended 
written  descriptions  are  given  below  a  HIPO  diagram  whenever 
it  is  deemed  necessary. 

A  complete  explanation  of  the  symbolic  notation  used  in 
the  HIPO  diagrams  appears  in  reference  1.2.1.  An  abbre¬ 
viated  legend  for  the  symbols  used  in  this  specification  is 
presented  in  Figure  2-1.  Note  that: 

a.  External  system  subroutines  are  depicted  partly 
in  the  Process  block  and  partly  out.  Internal 
subroutines  are  shown  within  the  Process  block. 

b.  Overview  diagrams  show  general  inputs  and  outputs 
only,  whereas  detail/subroutine-level  diagrams 
show  specific  input/output  tables  and/or  displays. 

c.  Rectangular  boxes  inside  the  Input/Output  block 
areas  are  generally  used  to  denote  single  data 
items.  Two  or  more  boxes  are  grouped  to  show  that 
several  data  items  are  input/output. 

d.  Rectangular  boxes  inside  the  Process  block  indi¬ 
cate  repetitive  subprocesses. 


4 


Control 


^  Dot*  mnni 
^  folatcr 


■--> 

=>Oi 


Onto  reference 


0= 


c> 


\(tyid  dot*  orrovo 


Control  flow  of  data 
anon|  eubproceeaee 


Subroutine  Invoked 
(Return  lo  node  to  callloi 
routine) 

Routine  receiver  control 


Routine  ealta  or  returns  control 


Subroutine 


Losleal  (rouping 
of  functlona 


r - -  1 

»  l 

•  .  function  Identified  but 

I  net  Included  In  package 

I  I 

t. _ «Ai 


Data  I ten 


or 


Data  Item 


dap  general  Input 
or  output  ltev 


(Online 
Storage 


Input /output  aedluei — 
lncluder  drun,  dlak, 
tape  dlakettea 


Information  display  by 
online  lsdlcatora—promptod 
by  prograt  eseeutlon  or  by 
keyboard  Input,  especially  CRT 


Magnetic  tape  Input/ 
output  aodliB 


Figure  2-1 

LEGEND  OF  HIPO  SYMBOLS 
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The  HIPO  diagram  identification  numbers  and  figure 
numbers  used  in  this  section  stand  alone;  i.e.,  they  start 
with  1.0,  increase  hierarchically,  and  are  independent  of 
the  numbering  scheme  used  to  this  point  in  this  document. 

Figure  2-2  is  a  system  structure  chart  and  represents 
the  overall  program  logic  flow  in  a  visual  table  of  contents. 
The  Visual  Table  of  Contents  diagram  shows  the  hierarchical 
structure,  the  functional  description  labels,  and  the  diagram 
(chart)  identifiers  of  functions  of  INFER. 


INFER 


Figure  2.2 

INFER  OVERVIEW  DIAGRAM 
AND  VISUAL  TABLE  OF  CONTENTS 
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Syttem  Program  _ INFER _  Name  _ _ _ 

Diagram  ID  1iP  jcontir>uad)_  Dy<cnp|lofl _ INFER _ _  P.iqe  — 2_  of 


10 


OUTCOME  NAMES  for  events  (-N  arrays) 


• 

N 

1 

UL 

X 

~p~ 

IT 

JJ 

ROW  3 


s  |  a  1 10 1  s  | 


Number  of  outcomes  for  node  3 


Number  of  associated  outcome  probabilities 
from  influencing  nodes  (number  joint  probabilities) 


I - The  number  of  influencing  nodes 


specified  (node  type) 

The  node  numbers  of 
directly  influencing  nodes 


PROBABILITY  TABLES 


10 


9 

10 


I 

10 


N  Probability  arrays 


CONDITIONED 


^Conditional  probabilities 


^Directly  assessed  value 


HIPO  Figure  2.1 

INFER  MODEL  DEFINITION  TABLES 


CONDITIONED  PROBABILITIES 


NODE  1 :  Terminal  Probabilities 
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HIPO  Figure  2.1 

INFER  MODEL  DEFINITION  TABLES  (continued) 
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HIPO  Figure  2.1.1 

EXAMPLE  OF  NODE  STRUCTURE  ELICITATION 


System/Program:  INFER _  Name:  _ 

Diagram  ID:  — 2a2 - Description  Create  the  List  of  Indicators _ _ _ _  page; 


1 

1 


J 


1-2.  The  user  is  prompted  for  both  the  indicator  label  and  the  event  name  which 
the  indicator  should  influence.  The  node  numerical  sequence  number  of  the 
influenced  event  node  is  placed  in  the  "On/Off"  status  table. 

3.  The  user  inputs  the  likelihoods  ratios  or  probability  values  along  each  event 
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System/Program:  _  INFER _  Name:  . 

Diagram  ID:  -24 _ Description _ Pjsp!ay.Results 
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beneath  the  respective  outcome  labels. 


Sy  item /Program : *NFER _  Name:  _ _ _ 

Diagram  ID:  -§s£ - Description _ Edit  the  Model _ _ _ _ _ __  page: 


2.  Changes  made  to  the  probabilities  or  the  number  of  indicators  require  the 
recomputation  of  marginal  probabilities. 


Extended  Description 

3.  The  current  model  structure,  whether  previously  modified  or  not,  is  input  to 
this  step. 


System/Program:  INFER  Name:  _ 

Diagram  ID:  Sit  -  Description _ Reset  Indicators, - —  -  —  Page: 


1.  The  user  may  have  many  tape  file*  on  which  INFER  formatted  models  are  4.  The  user  is  prompted  for  a  model  selection:  the  response  may  be  the  list  item 

stored.  In  this  step,  the  user  is  prompted  for  a  response  indicating  the  desired  tape  number  or  the  model  name.  The  requested  model  is  stored  in  the  same  tape  file  a 

is  mounted  and  online.  its  position  relative  to  the  other  model  names  in  the  displayed  list. 

3.  The  names  of  the  models  existing  on  the  mounted  tape  are  displayed  in  list  or 
Menu  format  so  that  the  user  may  select  a  model  for  loading. 
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System/Program:  INFER _  Name:  _ _ 

Diagram  ID:  JL2 _ rw»pt.»n  -Save  the  Current  Model  . . . paqe: 


System/Program. _ INFER _  Name:  _  _ _ _ _ 

Diagram  ID:  J&S _ Description  Sgve  the  Current  Model _ _  P,tqe  _2_  of 


6.  The  library  name  list  is  updated  to  reflect  the  new  file  structure.  The  new 
model  name's  position  in  the  LIBNAMES  array  must  be  the  same  relative 
position  to  other  models  stored  on  the  device. 


System/Program: _ INFER _  Name:  _ 

-  „ 8.2  _  .  Save  Model  Variables 

Diagram  ID:  - Description - 
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Extended  Description 

I.  The  file  location  Y  is  used  to  determine  an  exact  storage  position  on  the 
selected  device. 


